home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / enet_201.arc / EXTR_NET.DOC < prev    next >
Text File  |  1992-01-15  |  5KB  |  98 lines
  1.    
  2.                                   EXTR_NET
  3.                                 Version 2.01
  4.             Copyright (c) Bob Swift, 1988-91.  All Rights Reserved.
  5.              Compiled with the Turbo C++ 1.0 compiler from Borland.
  6.    
  7.    This program is designed to read an input nodelist file and extract
  8.    selected Networks, Regions and/or Zones.  The extracted portions of
  9.    the nodelist are stored in a file specified on the command line.
  10.  
  11.    The format for using this program is as follows:
  12.  
  13.    
  14.         EXTR_NET <srcfile> <destfile> <net1> <net2>...<net10>
  15.    
  16.    where <srcfile>    is the name of the nodelist file to be read
  17.          <destfile>   is the name of the output file created
  18.          <net..>      are the numbers of the Net/Region/Zones to be extracted
  19.                       (the program is presently set to handle 10 numbers).
  20.                       These numbers may be preceded by a N, R or Z in order
  21.                       to extract the entire Net, Region or Zone.  Examples
  22.                       are: 123 N140 r17 Z1
  23.    
  24.  
  25.    The nodelist may be specified with a full drive and path.  The destination
  26.    file must not have a drive or path specified.  It will be output to the 
  27.    current directory.
  28.    
  29.    The program will display a VERY brief set of instructions if it is called
  30.    without any arguments or if it encounters an error.  The following is a
  31.    list of the error codes returned by the program:
  32.    
  33.                   0 - No errors.  Normal termination.
  34.                   1 - Bad or missing command line argument.
  35.                   2 - Unable to open the input file.
  36.                   3 - Unable to open the output file.
  37.                   4 - Problem writing to output file.
  38.                   5 - Problem closing input file.
  39.                   6 - Problem closing output file.
  40.                   7 - Unable to open configuration file.
  41.                   8 - Unable to create backup file.
  42.    
  43.    When an error is encountered, the program will exit immediately and will
  44.    attempt to properly close all files.
  45.    
  46.    Although I have chosen to retain all rights to this program, you are free
  47.    to use it under the following conditions:
  48.    
  49.             - You realize that there is NO Warrantee of any sort.
  50.               It was tested pretty thoroughly here before release
  51.               but who knows what bugs may be lurking within.
  52.             
  53.             - You will not modify the code and release a new version
  54.               of the program.  I welcome suggestions for improvement
  55.               (especially when accompanied by code) but I make no
  56.               guarantee of future releases.
  57.             
  58.             - If you find the program useful, I ask that you do 
  59.               something to brighten somebody else's day.  Just 
  60.               exactly what, I will leave up to you.
  61.  
  62.    
  63.    You may freely distribute this program provided that you distribute only 
  64.    the complete archive which includes the EXTR_NET.EXE, EXTR_NET.C and
  65.    EXTR_NET.DOC.  In addition, You MUST NOT charge for the program nor can
  66.    you charge a copy fee over $4.00 (including the price of the diskette).  
  67.  
  68.    
  69.                                                    Bob Swift (1:140/24)
  70.  
  71.  
  72.     Revision History
  73.     ----------------
  74.  
  75.     1.00    88/11/08    First release version.
  76.  
  77.     1.01    88/11/08    Correct a minor problem with file names and the
  78.                         creation of the output backup file.
  79.  
  80.     1.10    88/11/09    Finally corrected the null pointer and backup bug
  81.                         for good this time.  Someday I will learn to handle
  82.                         strings properly <grin>.  Also cleaned up the error
  83.                         code handling section so that the error messages
  84.                         make sense and included comment lines in output
  85.                         file to show what input file was used and to
  86.                         separate each extracted Net/Region.
  87.  
  88.     2.00    89/05/07    Modified command line inputs slightly to allow
  89.                         extraction of entire Net, Region or Zone by specifying
  90.                         N, R or Z with the number.  Numbers entered with no
  91.                         specifier will be matched to anything but will only
  92.                         extract until the next occurence of a Host, Region or
  93.                         Zone statement.  Also echoed the search criteria to
  94.                         the output file.
  95.  
  96.     2.01    91/12/28    Cleaned up comments in output file.
  97.  
  98.